<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<STYLE>body{margin:3em;} pre{background:#ffc;}</STYLE>
<META NAME="generator" CONTENT="http://txt2tags.org">
<TITLE>TXT2TAGS</TITLE>
</HEAD><BODY BGCOLOR="white" TEXT="black">
<CENTER>
<H1>TXT2TAGS</H1>
<FONT SIZE="4">Nov, 2006</FONT>
</CENTER>

<P></P>
<HR NOSHADE SIZE=1>
<P></P>

  <UL>
  <LI><A HREF="#toc1">NAME</A>
  <LI><A HREF="#toc2">SYNOPSIS</A>
  <LI><A HREF="#toc3">BESCHREIBUNG</A>
  <LI><A HREF="#toc4">OPTIONEN</A>
  <LI><A HREF="#toc5">STRUKTUR</A>
  <LI><A HREF="#toc6">EINSTELLUNGSREGELN</A>
    <UL>
    <LI><A HREF="#toc7">EINSTELLUNGEN</A>
    </UL>
  <LI><A HREF="#toc8">SYNTAX</A>
    <UL>
    <LI><A HREF="#toc9">Grundlagen</A>
    <LI><A HREF="#toc10">Beautifiers</A>
    <LI><A HREF="#toc11">Text Blöcke</A>
    <LI><A HREF="#toc12">Andere</A>
    </UL>
  <LI><A HREF="#toc13">BEISPIELE</A>
  <LI><A HREF="#toc14">MAKROS</A>
  <LI><A HREF="#toc15">Autor</A>
  <LI><A HREF="#toc16">COPYRIGHT</A>
  </UL>

<P></P>
<HR NOSHADE SIZE=1>
<P></P>

<A NAME="toc1"></A>
<H1>NAME</H1>

<P>
txt2tags - Werkzeug für Text-Formatierung und -Konvertierung
</P>

<A NAME="toc2"></A>
<H1>SYNOPSIS</H1>

<P>
<B>txt2tags</B> [<I>OPTION</I>]... [<I>DATEI</I>]...
</P>

<A NAME="toc3"></A>
<H1>BESCHREIBUNG</H1>

<P>
<B>txt2tags</B> ist ein GPL Werkzeug für das Konvertieren von Formaten, geschrieben in Python. Es erzeugt <I>HTML</I>, <I>XHTML</I>, <I>SGML</I>, <I>LaTeX</I>, <I>Lout</I>,
<I>Man Page</I>, <I>MoinMoin</I>, <I>MagicPoint</I> und <I>PageMaker</I>
Dokumente aus einer einzigen Textdatei mit minimalem Markup.
</P>
<P>
Der Benutzer braucht nur die sehr wenigen und einfachen <B>txt2tags</B> Auszeichnungen zu wissen,
wobei er/sie einfache Textdateien schreibt. Dann tut das Programm all die schmutzige Arbeit, fügt komplizierte Tags hinzu und geht mit den Besonderheiten der Zieldokumente um.
</P>
<P>
Dieselbe Textdatei kann ohne weiteres Editieren in alle Zielformate konvertiert werden. Dies ist der Zweck von <B>txt2tags</B>: EINE Quelle, VIELE Zielformate.
</P>
<P>
Bitte besuchen Sie die Website des Programms unter
<I>http://txt2tags.org</I>.
</P>

<A NAME="toc4"></A>
<H1>OPTIONEN</H1>

<DL>
<DT> <B>-C</B>, <B>--config-file</B></DT><DD>
liest die Konfiguration aus einer externen Datei (arbeitet wie %!includeconf)
<P></P>
<DT>     <B>--css-sugar</B></DT><DD>
fügt die CSS-freundlichen Tags für HTML and XHTML Zielformate ein
<P></P>
<DT>     <B>--css-inside</B></DT><DD>
fügt den Inhalt von der CSS Datei in die HTML/XHTML Köpfe ein
<P></P>
<DT>     <B>--dump-config</B></DT><DD>
druckt alle gefundene Konfiguration und beendet das Programm
<P></P>
<DT>     <B>--dump-source</B></DT><DD>
druckt die Quelle des Dokuments, mit erweitertem Eingefügten
<P></P>
<DT>     <B>--encoding</B></DT><DD>
setzt das Encoding der Zieldatei (utf-8, iso-8859-1, etc)
<P></P>
<DT>     <B>--gui</B></DT><DD>
ruft das Graphical Tk Interface auf
<P></P>
<DT> <B>-h</B>, <B>--help</B></DT><DD>
druckt den Hilfetext und beendet das Programm
<P></P>
<DT> <B>-H</B>, <B>--no-headers</B></DT><DD>
unterdrückt Kopf, Titel und Fußzeile
<P></P>
<DT>     <B>--headers</B></DT><DD>
zeigt Kopf, Titel und Fußzeile (STANDARD EIN)
<P></P>
<DT> <B>-i</B>, <B>--infile</B>=<I>DATEI</I></DT><DD>
setzt DATEI als Name der Eingabedatei ('-' für STDIN)
<P></P>
<DT>     <B>--mask-email</B></DT><DD>
versteckt Email vor Spam Robotern. x@y.z ergibt &lt;x (a) y z&gt;
<P></P>
<DT> <B>-n</B>, <B>--enum-title</B></DT><DD>
nummeriert alle Überschriften wie 1, 1.1, 1.1.1, etc
<P></P>
<DT>     <B>--no-dump-config</B></DT><DD>
schaltet die Aktion dump Konfiguration aus
<P></P>
<DT>     <B>--no-dump-source</B></DT><DD>
schaltet die Aktion dump Quelltext aus
<P></P>
<DT>     <B>--no-encoding</B></DT><DD>
löscht die Einstellungen für das Encoding
<P></P>
<DT>     <B>--no-enum-title</B></DT><DD>
schaltet die Titel-Autonummerierung aus
<P></P>
<DT>     <B>--no-infile</B></DT><DD>
löscht alle vorigen Eingabedatei-Deklarationen
<P></P>
<DT>     <B>--no-mask-email</B></DT><DD>
macht Emails sichtbar, schaltet die --mask-email Option aus
<P></P>
<DT>     <B>--no-outfile</B></DT><DD>
löscht die vorige Ausgabedatei-Deklaration
<P></P>
<DT>     <B>--no-quiet</B></DT><DD>
zeigt Meldungen, schaltet die Option --quiet aus
<P></P>
<DT>     <B>--no-rc</B></DT><DD>
liest keine Benutzer-Konfigdatei ~/.txt2tagsrc
<P></P>
<DT>     <B>--no-style</B></DT><DD>
löscht die Einstellung des Stils
<P></P>
<DT>     <B>--no-toc</B></DT><DD>
fügt kein TOC (Table of Contents) ins Zieldokument ein
<P></P>
<DT>     <B>--no-toc-only</B></DT><DD>
schaltet die --toc-only Option aus
<P></P>
<DT> <B>-o</B>, <B>--outfile</B>=<I>DATEI</I></DT><DD>
setzt DATEI als Dateiname für die Ausgabe ('-' für STDOUT)
<P></P>
<DT> <B>-q</B>, <B>--quiet</B></DT><DD>
Schweigemodus, unterdrückt die Ausgabe (außer Fehler)
<P></P>
<DT>     <B>--rc</B></DT><DD>
liest Bentzer-Konfigdatei ~/.txt2tagsrc (Standard ist EIN)
<P></P>
<DT>     <B>--style</B>=<I>DATEI</I></DT><DD>
benutzt DATEI als Dokumentstil (wie Html CSS)
<P></P>
<DT><B>-t</B>, <B>--target</B></DT><DD>
setzt das Zielformat des Dokuments. aktuell unterstützt werden:
html, xhtml, sgml, tex, lout, man, mgp, moin, pm6, txt
<P></P>
<DT>     <B>--toc</B></DT><DD>
fügt die TOC (Table of Contents) ins Zieldokument ein
<P></P>
<DT>     <B>--toc-level</B>=<I>N</I></DT><DD>
setzt die maximale TOC Tiefe auf N
<P></P>
<DT>     <B>--toc-only</B></DT><DD>
druckt Dokument TOC und verläßt das Programm
<P></P>
<DT> <B>-v</B>, <B>--verbose</B></DT><DD>
druckt informative Meldungen während der Konvertierung
<P></P>
<DT> <B>-V</B>, <B>--version</B></DT><DD>
druckt die Programmversion und verläßt das Programm
</DL>

<P>
Als Standard werden konvertierte Ausgaben gespeichert nach 'datei.&lt;typ&gt;'.
Benutzt --outfile um einen Dateinamen für die Ausgabe zu erzwingen.
Wenn die Eingabedatei '-', lese von STDIN.
Wenn die Ausgabedatei '-', gebe aus nach STDOUT.
</P>

<A NAME="toc5"></A>
<H1>STRUKTUR</H1>

<P>
Die Txt2tags Quelldatei kann aus drei Bereichen bestehen:
</P>

<DL>
<DT><B>Kopf</B></DT><DD>
Die ersten drei Zeilen. Sie werden verwendet für die Unterscheidung des Dokuments.
Wenn Sie keine Kopfzeilen benötigen, müssen Sie die erste Zeile leer lassen oder
die Einstellung <CODE>no-header</CODE> setzen.
<P></P>
<DT><B>Einstellungen</B></DT><DD>
Beginnt an der vierten Zeile. Alle Einstellungen haben das Format %!schlüsselwort: wert. Einstellungen können gemacht werden in der Konfigurationsdatei oder auf der Kommandozeile.
<P></P>
<DT><B>Körper</B></DT><DD>
Ihre Dokument-Quelle! Der einzig erforderliche Bereich um eine gültige
txt2tags Datei zu erhalten.
</DL>

<A NAME="toc6"></A>
<H1>EINSTELLUNGSREGELN</H1>

<P>
Die Umwandlung einer Quelldatei kann angepaßt werden auf zwei unterschiedliche Weisen: Externe Konfigurationen werden aus der RC Datei genommen
(<CODE>~/.txt2tagsrc</CODE>) oder aus einer anderen vom Benutzer gewählte Datei. Interne
Konfigurationen werden durch Einstellungen vorgenommen. Beide verwenden dieselbe Syntax:
</P>

<DL>
<DT><B>%!target:</B></DT><DD>
definiert das Hauptziel
<P></P>
<DT><B>%!options(ziel):</B></DT><DD>
definiert die Optionen zu jedem Ziel
<P></P>
<DT><B>%!include: datei.t2t</B></DT><DD>
fügt eine txt2tags Datei in das Dokument ein
<P></P>
<DT><B>%!include: ``datei.txt``</B></DT><DD>
fügt eine Textdatei (verbatim) in das Dokument ein
<P></P>
<DT><B>%!include: datei.html</B></DT><DD>
fügt eine literale Datei in das Dokument ein, wie sie ist
<P></P>
<DT><B>%!style:</B></DT><DD>
lädt eine CSS (Cascading Style Sheets)-Datei für das XHTML und HTML
Zielformat oder \usepackage Module im TeX Format
<P></P>
<DT><B>%!encoding:</B></DT><DD>
legt einen Zeichensatz (wie iso-8859-1) für i18n fest
<P></P>
<DT><B>%!includeconf:</B></DT><DD>
wird benutzt, um Konfigurationen von einer externen in die aktuelle Datei zu übernehmen
<P></P>
<DT><B>%!guicolors:</B></DT><DD>
Farbeinstellungen für die GUI (Tk)
<P></P>
<DT><B>%!preproc:</B></DT><DD>
Ihr angepaßtes Filter (Makro), welches verarbeitet wird <B>VOR</B> dem 
Parsen des Dokuments
<P></P>
<DT><B>%!postproc:</B></DT><DD>
Ihr angepaßtes Filter (Makro), welches verarbeitet wird <B>NACH</B> dem 
Parsen des Dokuments
</DL>

<A NAME="toc7"></A>
<H2>EINSTELLUNGEN</H2>

 <UL>
 <LI>Einstellungen sind nur gültig innerhalb des Konfig-Bereichs, und werden als
   einfacher Kommentar betrachtet, wenn sie im Dokument stehen. Ausgenommen include,
   was ein gültiger Body-Befehl ist.
 <P></P>
 <LI>Wenn dasselbe Schlüsselwort mehr als einmal im Konfig-Bereich erscheint,
   wird das zuletzt gefundene benutzt. Ausgenommen: Optionen, preproc
   und postproc, welche kumulativ sind.
 <P></P>
 <LI>Eine Einstellungenzeile mit einem ungültigen Schlüsselwort wird betrachtet als eine
   einfache Kommentarzeile.
 <P></P>
 <LI>Diese Einstellungen haben Vorrang über die txt2tagsrc Datei, aber nicht über
   Optionen auf der Kommandozeile.
 </UL>

<A NAME="toc8"></A>
<H1>SYNTAX</H1>

<P>
Eine sehr einfache Markupsyntax wird in der Quelle des Dokuments (eine einfache Textdatei) verwendet, um Stukturen und Formatierung zu unterscheiden.
Hier ist die komplette Liste:
</P>

<A NAME="toc9"></A>
<H2>Grundlagen</H2>

<PRE>
  Headers                  Die ersten 3 Zeilen der Quelldatei
  Überschrift              = Wörter =
  Nummerierte Überschrift  + Wörter +
  Absatz                   Wörter
</PRE>

<A NAME="toc10"></A>
<H2>Beautifiers</H2>

<PRE>
  Fett                     **Wörter**
  Kursiv                   //Wörter//
  Understreichung          __Wörter__
  Mono                     ``Wörter``
</PRE>

<A NAME="toc11"></A>
<H2>Text Blöcke</H2>

<PRE>
  Quotierung               &lt;TAB&gt;Wörter
  Liste                    - Wörter
  Nummerierte Liste        + Wörter
  Definitions Liste        : Wörter
  Verbatim Zeile           ``` Wörter
  Verbatim Bereich         ```&lt;Zeilenumbruch&gt; Zeilen &lt;Zeilenumbruch&gt;```
  Rohe Zeile               """ Wörter
  Roher Bereich            """&lt;Zeilenumbruch&gt; Zeilen &lt;Zeilenumbruch&gt;"""
  Tabelle                  | Zelle1 | Zelle2 | Zelle3...
</PRE>

<A NAME="toc12"></A>
<H2>Andere</H2>

<PRE>
  Trennungszeile           -----------------------...
  Betonte Zeile            =======================...
  Links                    [Marke url]
  Bild                     [Dateiname.jpg]
  Roher Text               ""Wörter""
  Kommentare               % Kommentare
</PRE>

<P>
Lesen Sie bitte die Txt2tags Benutzeranleitung (im Verzeichnis für die Programmdokumentation), um eine ausführliche Beschreibung jeder Auszeichnung zu erhalten.
</P>

<A NAME="toc13"></A>
<H1>BEISPIELE</H1>

<P>
Angenommen Sie haben eine <CODE>file.t2t</CODE> Datei ausgezeichnet, lassen Sie uns etwas Spaß am Konvertieren haben.
</P>

<DL>
<DT><B>Konvertiere nach HTML, schreibe nach file.html</B></DT><DD>
<CODE>$ txt2tags -t html file.t2t</CODE>
<P></P>
<DT><B>Dasselbe, eine Umleitung benutzend</B></DT><DD>
<CODE>$ txt2tags -t html -o - file.t2t &gt; file.html</CODE>
<P></P>
<DT><B>Ein Inhaltsverzeichnis einfügen (TOC)</B></DT><DD>
<CODE>$ txt2tags -t html --toc file.t2t</CODE>
<P></P>
<DT><B>Ein TOC einfügen und Überschriften nummerieren</B></DT><DD>
<CODE>$ txt2tags -t html --toc --enum-title file.t2t</CODE>
<P></P>
<DT><B>Inhaltsverzeichnis, Schnell-Ansicht</B></DT><DD>
<CODE>$ txt2tags --toc-only file.t2t</CODE>
<P></P>
<DT><B>Schneller Einzeiler-Test vom STDIN</B></DT><DD>
<CODE>$ (echo ; echo "**bold**") | txt2tags -t html -H -</CODE>
</DL>

<A NAME="toc14"></A>
<H1>MAKROS</H1>

<DL>
<DT>%%date</DT><DD>
Erlaubt das aktuelle Datum einzufügen, in dem Format YYYYMMDD.
Optionale Formatierung kann angegeben werden unter Verwendung der
%%date(format-string) Syntax.
<P></P>
<DT>%%infile</DT><DD>
Wird benutzt, um Informationen über die Quelldatei zu bekommen. Optionale Formatierung kann angegeben werden unter Verwendung der %%infile(format-string) Syntax.
<P></P>
Brauchbar für Fußnotenlinks wie [Siehe Quelle %%infile], so können Sie
den Dateinamen ändern und seine Referenzen werden aktualisiert.
<P></P>
<DT>%%mtime</DT><DD>
<P></P>
Gibt Information über die Zeit der letzten Änderung der Quelldatei. Es verwendet dieselben Formater, die vom %%date Makro akzeptiert werden.
<P></P>
<DT>%%outfile</DT><DD>
Wird benutzt, um Informationen zu bekommen über die konvertierte Datei. Optionale Formatierung kann angegeben werden unter Verwendung der %%outfile(format-string) Syntax.
<P></P>
Brauchbar für Selbstreferenzen wie "Dies ist eine manpage-de.html Datei", so können Sie den Dateinamen wechseln und seine Referenz wird aktualisiert.
<P></P>
<DT>%%toc</DT><DD>
Das %%toc Makro gibt an, wo das TOC des Dokuments platziert wird. Sie können es platzieren, wo immer es im Dokument gebraucht wird.
<P></P>
Hinweis: %%toc wird erweitert nur mit der --toc Option.
</DL>

<A NAME="toc15"></A>
<H1>Autor</H1>

<P>
Geschrieben und betreut durch Aurelio Jargas &lt;&lt;verde (a) aurelio net&gt;&gt;
</P>
<P>
Diese Anleitung wurde geschrieben von Jose Inacio Coelho &lt;&lt;jic (a) technologist com&gt;&gt;
als eine Textdatei, und dann konvertiert ins man Format durch <B>txt2tags</B>!
</P>
<P>
Übersetzt von Michael Malien &lt;&lt;michael malien (a) gmx de&gt;&gt;.
</P>

<A NAME="toc16"></A>
<H1>COPYRIGHT</H1>

<P>
Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006 Aurelio Jargas
</P>
<P>
Dies ist freie Software; siehe die Quelle für Kopierbedingungen. Es gibt keine GEWÄHR; nicht einmal für Verkaufbarkeit oder Eignung für einen besonderen Zweck.
</P>

<!-- html code generated by txt2tags 2.6 (http://txt2tags.org) -->
<!-- cmdline: txt2tags -t html doc/German/manpage-de.t2t -->
</BODY></HTML>
